安装介质说明和准备

微应用安装介质前提是已经安装AFCenter8.2.6环境。 哑安装介质，目录如下：

primeton-installer-1.2.2.tar
├─ config //配置文件
├─ drivers //数据库驱动目录
├─ lib//哑安装相关jar
├─ logs //哑安装日志
├─ install.cmd //windows环境启动脚本
├─ install.sh//linux环境启动脚本
├─ README.md //使用文档

微应用安装介质有两个：前端介质、后端介质 。 前端目录如下：

Primeton_APIGateway_9.0_LA_Console.tar
├── Developer
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── DevOps
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── Manager
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── esb.conf //nginx配置文件

后端目录如下：

Primeton_APIGateway_9.0_LA_Governor.tar
├── bin //启动脚本
├── config //配置文件
├── db-scripts //部署db脚本
├── governor //模板文件
├── lib //依赖的相关jar
├── com.primeton.esb.governor.boot-9.0.0.0-LA.jar //服务jar

APIGateway微应用版, 必须同时安装AFCenter和APIGateway微应用版，且必须按照如下步骤安装：

1.先创建AFCenter的数据库，执行AFCenter的初始化脚本。

2.安装APIGateway Governor，在AFCenter的数据库执行${APIGateway-governor安装目录}/db-scripts/ESB/Mysql/1-esb-afc-data.sql。

3.安装AFCenter。

4.启动AFCenter。

5.启动APIGateway Governor。 

安装与配置

1.哑安装APIGateway Governor微应用后端

1.解压primeton-installer-1.2.2.tar到/opt/primeton/APIGateway/primeton-installer-1.2.2文件下。

2.将MySQL数据库驱动包拷贝到primeton-installer-1.2.2/drivers目录下。

MySQL哑安装需要使用5.x版本的驱动，如果APIGateway Governor运行时想使用8.x版本，可以在哑安装完成后，手动删除${APIGateway-governor安装目录}/lib目录的5.x驱动，重新放入8.x驱动

3.复制primeton-installer-1.2.2/config/template/governor目录下的所有文件到primeton-installer-1.2.2/config目录下。

4.修改primeton-installer-1.2.2/config/install.properties配置文件，其中数据库连接配置需要和AFCenter一致（数据库默认编码为UTF-8），详细配置如下：

#带安装介质目录
zipPath=/opt/primeton/Primeton_APIGateway_9.0_LA_Governor.tar
#产品安装目标目录
destPath=/opt/primeton/governor
#当安装目录不存在时是否自动创建
autoCreateDir=true
#当安装目录不为空时是否强制覆盖
coverByForce=true
 
#是否数据库脚本初始化，若初始化initDB为true,强制初始化需initDB和forceInitDB同时配置为true
initDB=true
forceInitDB=true
 
# DB config
dbType=mysql
dbDriver=com.mysql.jdbc.Driver
dbUrl=jdbc:mysql://127.0.0.1:3306/esb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8&useSSL=false
dbUserName=root
dbPassword=root
 
#数据库方言配置
dialect=org.hibernate.dialect.MySQLDialect
 
#Redis配置
redisHost=127.0.0.1
redisPort=6379
redisPassword=primeton
 
#AFCenter配置
afcName=127.0.0.1:28081
afcTenant=sys_tenant
afcAppCode=AFC
afcAppSecret=secret
 
#Elasticsearch配置
elasticsearchEnabled=true
 
#若elasticsearch有用户名密码，需配置以下配置
elasticsearchUsername=elastic
elasticsearchPassword=primeton000000
 
#elasticsearch server IP
elasticsearchIP=127.0.0.1
elasticsearchPort=9200
elasticsearchProtocol=https
elasticsearchCertificate=/usr/local/elasticsearch/elasticsearch-8.1.2/config/certs/http_ca.crt 

参数	说明
zipPath	APIGateway-governor后端安装包Primeton_APIGateway_9.0_LA_Governor.tar的绝对路径。
destPath	APIGateway-governor后端的安装路径。
dbtype	数据库类型。
dbDriver	数据库驱动类。
dbUrl	数据库的jdbc url。
dbUserName	数据库用户名。
dbPassword	数据库密码。
database-platform	数据库方言类。
redisHost	redis的ip地址
redisPort	redis的端口。
redisPassword	redis的密码。
afcName	afcenter后端服务的IP和端口
afcTenant	afcenter的租户编码
afcAppCode	afcenter的应用编码
elasticsearchEnabled	是否启动ElasticSearch。
elasticsearchUsername	ElasticSearch的用户名。
elasticsearchPassword	ElasticSearch的密码。
elasticsearchIP	ElasticSearch的IP地址。
elasticsearchPort	ElasticSearch的端口。
elasticsearchProtocol	ElasticSearch的http的类型。
elasticsearchCertificate	ElasticSearch的证书的绝对路径。

5.配置完成后，执行如下命令，启动哑安装。

# ./install.sh

说明：

1).为了保证密码安全，哑安装成功后，请立即删除primeton-installer-1.2.2/config/install.properties文件。

2).查看1.1 安装须知，检查您所需要的数据库驱动包是否已被内置在产品中。如下图

如果没有内置，则需在哑安装完成后，手动删除${APIGateway -governor安装目录}/lib目录的同数据库其他版本驱动。 例如：您需要连接的数据库是Mysql 8，但是产品已内置的是Mysql 5的驱动包。您需要在哑安装完成后，手动删除${APIGateway -governor安装目录}/lib目录的下面已内置的Mysql 5的驱动包。

6.如果要使用sap服务器，需要将sapjco.zip (opens new window) 中对应操作系统下的libsapjco3.so和sapjco3.jar文件复制到“${APIGateway-governor安装目录}/lib”目录下

微服务环境，{APIGateway-governor}安装目录/config/下application-afc.properties文件中的eos.application.sys-code
和eos.application.sys-key参数需要和{afcenter}安装目录/config/下application.properties文件中保持一致。

2.afcenter数据库初始化APIGateway脚本

1.APIGateway-governor哑安装完成后，进入${APIGateway-governor安装目录}/db-scripts/ESB/Mysql目录，初始化APIGateway的数据到AFCenter库，执行如下脚本：

1-esb-afc-data.sql

微服务环境，如果AFCenter的数据库与APIGateway的数据库类型不一致，请执行${APIGateway-governor安装目录}/db-scripts/ESB/{AFCenter对应数据库类型}
下的1-esb-afc-data.sql脚本文件

前端配置

1.修改{nginx安装目录}/conf/nginx.conf配置文件，新增APIGateway的配置：

location /api/ {# APIGateway配置

        proxy_pass http://IP:Port/api/;# 修改APIGateway-governor的IP和端口

}

2.找到已经部署完的介质EOS_Platform_8.2.5的前端部署路径/web/afcenter

3.把介质Primeton_APIGateway_9.0_LA_Console里所有目录，复制到介质EOS_Platform_8.2.5的前端资源/web/afcenter内

如果是独立安装的afcenter，则把Primeton_APIGateway_9.0_LA_Console里所有目录复制到afcenter前端安装目录中。

4.进入{nginx安装目录}/sbin下,执行./nginx -s reload命令重启nginx

启动服务

1.在${APIGateway-governor安装目录}下执行如下命令，启动APIGateway Governor。

# nohup ./startServer.sh & 

2.启动成功后，进入${APIGateway-governor安装目录}/logs目录，打开eos-trace.log文件 查看具体日志，如下图所示:

环境登录和验证

1.访问http://nginx机器IP:前端Port，使用APIGateway管理员登录，用户名/密码为：manager/000000，进入如下界面，表示APIGateway Governor系统部署成功，如下图所示:

此版本支持三员管理，三员管理分为系统管理员、安全管理员、安全审计员

系统管理员负责创建用户、删除用户，系统管理员用户名：systemadmin，初始密码：000000

安全管理员负责给用户分配角色，角色权限设置，安全管理员用户名：security，初始密码：000000

安全审计员负责查看Governor操作日志，安全审计员用户名：audit，初始密码：000000
        
备注：

1.如果连续 5 次输入错误密码，则用户会被锁定 30 分钟

2.新创建的用户，首次登录后需重新修改密码，默认用户首次登录不需要修改密码，如果需要修改密码，请使用systemadmin用户在账号管理页面，重新设置默认用户的密码

卸载

1.在${APIGateway-governor安装目录}下，执行如下命令，停止APIGateway Governor服务。

# ./stopServer.sh

2.停止服务后，可以直接删除${APIGateway-governor安装目录}进行卸载。